home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3x / curs_insstr.z / curs_insstr
Encoding:
Text File  |  2002-10-03  |  6.2 KB  |  66 lines
  1.  
  2.  
  3.  
  4. ccccuuuurrrrssss____iiiinnnnssssssssttttrrrr((((3333XXXX))))                                                ccccuuuurrrrssss____iiiinnnnssssssssttttrrrr((((3333XXXX))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _cccc_uuuu_rrrr_ssss______iiii_nnnn_ssss_ssss_tttt_rrrr:  _iiii_nnnn_ssss_ssss_tttt_rrrr, _iiii_nnnn_ssss_nnnn_ssss_tttt_rrrr, _wwww_iiii_nnnn_ssss_ssss_tttt_rrrr, _wwww_iiii_nnnn_ssss_nnnn_ssss_tttt_rrrr, _mmmm_vvvv_iiii_nnnn_ssss_ssss_tttt_rrrr, _mmmm_vvvv_iiii_nnnn_ssss_nnnn_ssss_tttt_rrrr,
  10.      _mmmm_vvvv_wwww_iiii_nnnn_ssss_ssss_tttt_rrrr, _mmmm_vvvv_wwww_iiii_nnnn_ssss_nnnn_ssss_tttt_rrrr - insert string before character under the cursor
  11.      in a _cccc_uuuu_rrrr_ssss_eeee_ssss window
  12.  
  13. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  14.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_cccc_uuuu_rrrr_ssss_eeee_ssss_...._hhhh_>>>>
  15.      _iiii_nnnn_tttt _iiii_nnnn_ssss_ssss_tttt_rrrr_((((_cccc_hhhh_aaaa_rrrr _****_ssss_tttt_rrrr_))))_;;;;
  16.      _iiii_nnnn_tttt _iiii_nnnn_ssss_nnnn_ssss_tttt_rrrr_((((_cccc_hhhh_aaaa_rrrr _****_ssss_tttt_rrrr_,,,, _iiii_nnnn_tttt _nnnn_))))_;;;;
  17.      _iiii_nnnn_tttt _wwww_iiii_nnnn_ssss_ssss_tttt_rrrr_((((_WWWW_IIII_NNNN_DDDD_OOOO_WWWW _****_wwww_iiii_nnnn_,,,, _cccc_hhhh_aaaa_rrrr _****_ssss_tttt_rrrr_))))_;;;;
  18.      _iiii_nnnn_tttt _wwww_iiii_nnnn_ssss_nnnn_ssss_tttt_rrrr_((((_WWWW_IIII_NNNN_DDDD_OOOO_WWWW _****_wwww_iiii_nnnn_,,,, _cccc_hhhh_aaaa_rrrr _****_ssss_tttt_rrrr_,,,, _iiii_nnnn_tttt _nnnn_))))_;;;;
  19.      _iiii_nnnn_tttt _mmmm_vvvv_iiii_nnnn_ssss_ssss_tttt_rrrr_((((_iiii_nnnn_tttt _yyyy_,,,, _iiii_nnnn_tttt _xxxx_,,,, _cccc_hhhh_aaaa_rrrr _****_ssss_tttt_rrrr_))))_;;;;
  20.      _iiii_nnnn_tttt _mmmm_vvvv_iiii_nnnn_ssss_nnnn_ssss_tttt_rrrr_((((_iiii_nnnn_tttt _yyyy_,,,, _iiii_nnnn_tttt _xxxx_,,,, _cccc_hhhh_aaaa_rrrr _****_ssss_tttt_rrrr_,,,, _iiii_nnnn_tttt _nnnn_))))_;;;;
  21.      _iiii_nnnn_tttt _mmmm_vvvv_wwww_iiii_nnnn_ssss_ssss_tttt_rrrr_((((_WWWW_IIII_NNNN_DDDD_OOOO_WWWW _****_wwww_iiii_nnnn_,,,, _iiii_nnnn_tttt _yyyy_,,,, _iiii_nnnn_tttt _xxxx_,,,, _cccc_hhhh_aaaa_rrrr _****_ssss_tttt_rrrr_))))_;;;;
  22.      _iiii_nnnn_tttt _mmmm_vvvv_wwww_iiii_nnnn_ssss_nnnn_ssss_tttt_rrrr_((((_WWWW_IIII_NNNN_DDDD_OOOO_WWWW _****_wwww_iiii_nnnn_,,,, _iiii_nnnn_tttt _yyyy_,,,, _iiii_nnnn_tttt _xxxx_,,,, _cccc_hhhh_aaaa_rrrr _****_ssss_tttt_rrrr_,,,, _iiii_nnnn_tttt _nnnn_))))_;;;;
  23.  
  24. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  25.      These routines insert a character string (as many characters as will fit
  26.      on the line) before the character under the cursor.  All characters to
  27.      the right of the cursor are moved to the right, with the possibility of
  28.      the rightmost characters on the line being lost.  The cursor position
  29.      does not change (after moving to _y, _x, if specified).  (This does not
  30.      imply use of the hardware insert character feature.)  The four routines
  31.      with _n as the last argument insert at most _n characters.  If _n<=0, then
  32.      the entire string is inserted.
  33.  
  34.      If a character in _s_t_r is a tab, newline, carriage return, or backspace,
  35.      the cursor is moved appropriately within the window.  A newline also does
  36.      a _cccc_llll_rrrr_tttt_oooo_eeee_oooo_llll before moving.  Tabs are considered to be at every eighth
  37.      column.  If a character in _s_t_r is another control character, it is drawn
  38.      in the _^^^^_X notation.  Calling _wwww_iiii_nnnn_cccc_hhhh after adding a control character (and
  39.      moving to it, if necessary) does not return the control character, but
  40.      instead returns the representation of the control character.
  41.  
  42. RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  43.      All routines return the integer _EEEE_RRRR_RRRR upon failure and an integer value
  44.      other than _EEEE_RRRR_RRRR upon successful completion.
  45.  
  46. NNNNOOOOTTTTEEEESSSS
  47.      The header file _cccc_uuuu_rrrr_ssss_eeee_ssss_...._hhhh automatically includes the header files _ssss_tttt_dddd_iiii_oooo_...._hhhh
  48.      and _uuuu_nnnn_cccc_tttt_rrrr_llll_...._hhhh.
  49.  
  50.      Note that all but _wwww_iiii_nnnn_ssss_nnnn_ssss_tttt_rrrr may be macros.
  51.  
  52. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  53.      _cccc_uuuu_rrrr_ssss_eeee_ssss(3X), _cccc_uuuu_rrrr_ssss______cccc_llll_eeee_aaaa_rrrr(3X), _cccc_uuuu_rrrr_ssss______iiii_nnnn_cccc_hhhh(3X)
  54.  
  55.  
  56.  
  57.  
  58.  
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.